Skip to main content

Variáveis Globais

As variáveis globais são geradas automaticamente pelo sistema a cada sessão. Elas podem ser usadas em qualquer bloco de texto com a sintaxe {nome.variavel}.

global.*​

Variáveis de sistema, disponíveis em todas as sessões.

  • global.date: Data atual do sistema. O GMT configurado no bot é aplicado nesta variável.

    • Formato: DD/MM/AAAA
    • Exemplo: 25/05/2026

  • global.hour: Hora atual do sistema. O GMT configurado no bot é aplicado nesta variável.

    • Formato: HH:mm:ss
    • Exemplo: 14:30:45

  • global.datehour: Data e hora atual do sistema. O GMT configurado no bot é aplicado nesta variável.

    • Formato: DD/MM/AAAA HH:mm:ss
    • Exemplo: 25/05/2026 14:30:45

  • global.workingNow: Esta variável irá atuar com base nos horários de atendimento cadastrados e também nos dias de Folga cadastrados, para informar se o bot está em atendimento ou não.

    • Retorna: true ou false

    • Exemplo: se o usuário cadastrar o horário de atendimento com as datas de segunda e terça, das 8h às 12h, e receber uma mensagem, terça às 16h, a variável workingNow irá retornar um false.

    • Como o usuário pode cadastrar mais de um horário de atendimento atualmente, caso ele use a variável apenas como: global.workingNow o fluxo irá pegar o primeiro horário cadastrado, caso utilize global.workingNow.1 também irá pegar o primeiro. Da mesma forma, caso tenha mais horários cadastrados e utilize global.workingNow.INDICE (global.workingNow.2) irá pegar o horário correspondente ao índice.

    • Outro exemplo de uso da variável é que caso o usuário tente utilizar um workingNow que não exista o fluxo irá retornar um true, exemplo: caso tenham 3 horários cadastrados e o usuário tente utilizar global.workingNow.4

    • A variável workingNow também funciona com base nos dias de Folga cadastrados, caso no momento em que o fluxo estiver acontecendo e tenha um dia de folga cadastrado para hoje, o workingNow irá trazer false, caso o dia de folga cadastrado seja de ontem por exemplo, o fluxo irá trazer true para o workingNow.

  • global.isHoliday: Indica se a data atual é um dia de folga configurado no bot.

    • Retorna: true ou false

  • global.session: ID único da sessão atual.

    • Exemplo: 64f3c1a2b9e...

  • global.contactnumber: Número de contato do cliente na sessão.

    • Exemplo: 5511999999999

  • global.contactName: Nome do cliente cadastrado no canal (ex: nome salvo no WhatsApp). Retorna o número de contato caso o nome não esteja disponível.

    • Exemplo: João Silva

  • global.firstmessage: Primeira mensagem enviada pelo cliente nesta sessão.

    • Exemplo: Olá, preciso de ajuda

  • global.lastAnswer: Última mensagem enviada pelo cliente.

    • Exemplo: Sim, confirmo

  • global.channel: Canal de atendimento da sessão.

    • Valores possíveis: whatsapp, webchat, messenger, instagram

  • global.numberchip: Número do chip/broker que recebeu a mensagem do cliente.

    • Exemplo: 5511999999999

  • global.lastTags: Última tag atribuída na sessão.

    • Exemplo: Interesse

  • global.tagsHistory: Histórico de todas as tags atribuídas na sessão, separadas por vírgula.

    • Exemplo: Interesse,Finalizado

  • global.lastIntent: Última intenção identificada pelo motor de IA.

    • Exemplo: saudacao

  • global.lastEntity: Última entidade extraída pelo motor de IA.

    • Exemplo: produto

  • global.lastConfidence: Nível de confiança da última resposta do motor de IA. Valor entre 0 e 1.

    • Exemplo: 0.95

  • global.hasConditional: Indica se o último bloco condicional foi executado com sucesso.

    • Retorna: true ou false

  • global.lastMessageType: Tipo da última mensagem recebida do cliente.

    • Valores possíveis: Text, Audio, Video, Image, Document

  • global.sessionKey: Chave interna da sessão no sistema.

omni.*​

Variáveis populadas durante ou após um atendimento humano realizado pela plataforma Omni. Ficam disponíveis quando o fluxo retorna do atendimento humano.

  • omni.email — E-mail do cliente registrado no atendimento.
  • omni.telefone — Telefone do cliente registrado no atendimento.
  • omni.nome — Nome do cliente.
  • omni.sobrenome — Sobrenome do cliente.
  • omni.documento — CPF ou CNPJ do cliente.
  • omni.tipo_documento — Tipo de documento informado (CPF ou CNPJ).
  • omni.tag — Tag de finalização do atendimento humano.
  • omni.lastAgentName — Nome do último agente que realizou o atendimento.
  • omni.protocol — Número do protocolo gerado no atendimento humano.
  • omni.zendeskId — ID do ticket no Zendesk (disponível quando há integração Zendesk ativa).
  • omni.comment — Anotação ou comentário inserido pelo agente durante o atendimento.
  • omni.header — Informações de cabeçalho enviadas pela plataforma Omni.

client.*​

Variáveis populadas durante ou após um atendimento humano em configuração customizada (sem integração Omni). Ficam disponíveis quando o fluxo retorna do atendimento humano.

  • client.email — E-mail do cliente.
  • client.telefone — Telefone do cliente.
  • client.nome — Nome do cliente.
  • client.sobrenome — Sobrenome do cliente.
  • client.documento — CPF ou CNPJ do cliente.
  • client.tipo_documento — Tipo de documento informado (CPF ou CNPJ).
  • client.protocolo — Protocolo customizado do atendimento.
  • client.comment — Anotação ou comentário inserido pelo agente durante o atendimento.

ads.*​

Variáveis populadas quando o cliente inicia a conversa a partir de um anúncio (ex: anúncio Click-to-WhatsApp no Facebook/Instagram).

  • ads.sourceType — Tipo de origem do anúncio.
  • ads.body — Texto/corpo do anúncio que originou a conversa.
  • ads.sourceUrl — URL de origem do anúncio.
  • ads.headline — Título do anúncio.
  • ads.ctwaClickId — ID de clique CTWA (Click-to-WhatsApp).
  • ads.sourceId — ID de origem do anúncio.

bot.*​

Variáveis de escopo global do bot, compartilhadas entre todas as sessões ativas. São configuradas diretamente nas configurações do bot.

Atenção: diferente das demais variáveis, bot.* não são por sessão, qualquer alteração afeta todas as conversas em andamento.